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Copyright Notification 

No part may be reproduced except as authorized by written permission. 
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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under 
http ://webapp . etsi.org/kev/queryform. asp . 
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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.661: "Configuration Management (CM); Kernel CM; Requirements". 

32.662: "Configuration Management (CM); Kernel CM; Information Service (IS)". 

32.663: "Configuration Management (CM); Kernel CM Integration Reference Point (IRP): Common 

Object Request Broker Architecture (CORBA) Solution Set (SS)". 

32.665 Configuration Management (CM); Kernel CM Integration Reference Point (IRP): extensible 

Markup Language (XML) definitions. 

32.667: "Configuration Management (CM); Kernel CM Integration Reference Point (IRP): SOAP 

solution set". 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are 
initiated either as single actions on single NEs of the 3G network, or as part of a complex procedure involving actions 
on many resources/objects in one or several NEs. 
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Scope 



The purpose of the present document is to define the mapping of the Kernel CM IRP: IS (3GPP TS 32.662 [4]) to the 
protocol specific details necessary for implementation of this IRP in a SOAP/WSDL environment. 

This Solution Set specification is related to 3GPP TS 32.662 (V7.0.x). 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.600: "Telecommunication management; Configuration Management (CM); Concept 

and high-level requirements". 

[4] 3GPP TS 32.662: "Telecommunication management; Configuration Management (CM); Kernel 

CM; Information Service (IS)". 

[5] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[6] 3GPP TS 32.311: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[7] 3GPP TS 32.172: "Telecommunication management; Subscription Management (SuM) IRP; 

Network Resources Model (NRM)" 

[8] 3GPP TS 32.317: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Simple Object Access Protocol (SOAP) Solution Set (SS)". 

[9] 3GPP TS 32.307: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Simple Object Access Protocol (SOAP) Solution 
Set(SS)". 

[10] W3C SOAP 1.1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 

[II] W3C WSDL 1 . 1 specification ( http://www.w3.org/TR/2001/NOTE-wsdl-20010315) 
[12] W3C XPath 1.0 specification ( http://www.w3.org/TR/1999/REC-xpath-19991 1 16) 

[13] WS-I Basic Profile Version 1 . 1 ( http://www.ws-i.org/Profiles/BasicProfile-l.l-2004-08-24.html) 

[14] W3C SOAP 1.2 specification ( http://www.w3.org/TR/soapl2-partl/) 

[15] 3GPP TS 32.665: "Telecommunication management; Configuration Management (CM); Kernel 

CM; extensible Markup Language (XML) definition". 
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Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.600 [3] and 3GPP TS 32.662 [4] apply. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

DN Distinguished Name 

IRP Integration Reference Point 

IS Information Service 

MO Managed Object 

MOC Managed Object Class 

NRM Network Resource Model 

SS Solution Set 

WSDL Web Service Description Language 

WST Web Services Interoperability Organization 



IRP document version number string 



The IRP document version number (sometimes called "IRPVersion" or "SS version number") string is used to identify 
this specification. The string is derived using a rule described in 3GPP TS 32.31 1 [6]. The value of this string is defined 
by a constant in annex A. 

This string (or sequence of strings, if more than one version is supported) is returned in get IRPVer s ion method and 
is carried in the first field of the notification header of all notifications related to this IRP. 



5 Architectural features 

5.1 General 

The overall architectural feature of Kernel Configuration Management IRP is specified in 3GPP TS 32.662 [4]. 
This clause specifies features that are specific to the SOAP SS. 

The SOAP 1.1 specification [10] and WSDL 1.1 specification [13] are supported. 

The SOAP 1.2 specification [14] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

This specification uses a number of namespace prefixes throughout that are listed in Table 5.1. 
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Table 5.1 : Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


http 


http://schemas.xmlsoap.org/wsdl/http/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


SOAP-ENV 


http://schemas.xmlsoap.org/soap/envelope/ 


SOAP-ENC or 
soapenc 


http://schemas.xmlsoap.org/soap/encoding/ 


xs or xsd 


http://www.w3.org/2001/XMLSchema 


xsi 


http://www.w3.org/2001/XMLSchema-instance 


kernelCMIRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32 series/32667/schema/32667- 
700/KernelCMIRPSystem 


kernelCMIRPData 


http://www.3gpp.org/ftp/Specs/archive/32 series/32667/schema/32667-700/KernelCMIRPData 


ntflRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32_series/32307/schema/32307- 
700/notification/NotificationlRPNtfSystem 


genericlRPSystem 


http://www.3gpp.org/ftp/Specs/archive/32_series/32317/schema/32317-700/GenericlRPSystem 



The WSDL structure is like Figure 5.1: 



Operations 



El- 5 getlRPVersion 

Etl ■ ^ getD perat ionProf ile 

&■■■+£ getNotificationProfile 

E1-+1 getNRMIRPVersion 



PortTypes 



Bindings 



+ 



KernelCMIRP 



Services 



B-__ KernelCMIRP 
1 €L KernelCMIRP 



Figure 5.1 : kernelCM IRP SOAP Solution Set WSDL structure 

5.2 Notifications 

Notifications are sent according to the Notification IRP: SOAP SS (see 3GPP TS 32.307 [9]). 

The contents of the Kernel CM IRP notifications are defined in KernelCM IRP XML definition [15]. 

5.3 Syntax for Distinguished Names and Versions 

The format of a Distinguished Name is defined in 3GPP TS 32.300 [5]. 
The version of this IRP is represented as a string (see also clause 4). 



6 Mapping 

6.1 General mappings 

The IS parameter name managedObjectlnstance is mapped into DN. 

Attributes modelling associations as defined in the NRM (here also called "reference attributes") are in this SS mapped 
to attributes. The names of the reference attributes in the NRM are mapped to the corresponding attribute names in the 
MOC. When the cardinality for an association is 0..1 or 1..1 the datatype for the reference attribute is defined as an 
MOReference. The value of an MO reference contains the distinguished name of the associated MO. When the 
cardinality for an association allows more than one referred MO, the reference attribute will be of type 
MOReferenceSet, which contains a sequence of MO references. 

If a reference attribute is changed, an AttributeValueChange notification is emitted. 
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6.2 Operation and Notification mapping 

The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) defines semantics of operation and notification visible across the 
Kernel Configuration Management IRP. The following table in this subclause indicates mapping of these operations and 
notifications to their equivalents defined in this SS. 

Table 6.2: Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 
(3GPP TS 32.662 [4]) 


SS Operation 


Qualifier 


getNRMIRPVersion 


getNRMIRPVersion 


M 


notifyObjectCreation 


ntflRPSystermnotify (note 2) 


O 


notifyObjectDeletion 


ntflRPSystermnotify (note 2) 


O 


notifyAttributeValueChange 


ntflRPSystermnotify (note 2) 





notifyCMSynchronizationRecommended 


ntflRPSystermnotify (note 2) 





notifyStateChange 


ntflRPSystermnotify (note 2) 





getlRPVersion(see note 1) 


getlRPVersion 


M 


getOperationProfile(see note 1) 


getOperationProfile 


O 


getNotificationProfile(see note 1) 


getNotificationProfile 





NOTE 1 : This operation is of IOC ManagedGenericIRP specified in [10]. The IOC KernelCmIRP of [4] inherits from it. 


NOTE 2: The IS equivalent is mapped into parameters of ntflRPSystem::notify. 



6.3 Operation parameter mapping 



The Kernel CM IRP: IS (3GPP TS 32.662 [4]) defines semantics of parameters carried in operations across the Kernel 
Configuration Management IRP. The tables below show the mapping of these parameters, as per operation, to their 
equivalents defined in this SS. 

6.3.1 Operation getNRMIRPVersion 

6.3.1 .1 Input parameters 

None. 

Here is the XML schema fragment of the getNRMIRPVersion request: 

<! — getNRMIRPVersion Request — > 
<element name="getNRMIRPVersion"> 
</element> 

6.3.1 .2 Output parameters 

Table 6.3.1.2: Mapping from IS getNRMIRPVersion output parameters to SS equivalents 



IS Operation parameter 


SS Operation parameter 


Qualifier 


versionNumberList 


kernelCMIRPData:VersionNumberSetType versionNumberSet 


M 


vSEVersionNumberList 


kernelCMIRPData:VersionNumberSetType vSEVersionNumberList 


M 


status 


kernelCMIRPData:getNRMIRPVersionFault 


M 



Here is the XML schema fragment of the getNRMIRPVersion response: 



<! — getNRMIRPVersion Response — > 
<element name="getNRMIRPVersionResponse"> 
<complexType> 
<sequence> 

<element name=" versionNumberList " type="kernelCMIRPData : Vers ionNumber Set Type" /> 
<element name="vSEVersionNumberList " type=" 
kernelCMIRPData:VersionNumberSetType"/> 

</sequence> 
</complexType> 
</element> 
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6.3.1.3 Fault definition 

<! — getNRMIRPVersion Fault — > 
<element name="getNRMIRPVersionFault "> 
<complexType> 
<choice> 

<element name="getNRMIRPVersionFault " type="string"/> 
</choice> 
</complexType> 
</element> 
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Annex A (normative): 
WSDL Specification 



<?xml version=" 1.0" encoding="UTF-8 " ?> 

< definitions xmlns="http : / /schema s . xmlsoap . org/wsdl/ " 

xmlns : soap="http : / /schema s . xmlsoap . org/wsdl /soap/ " 

xmlns : http="http : / /schema s . xmlsoap . org/wsdl /http/ " xmlns : xs="http : //www. w3 . org/2001 /XML Schema" 

xmlns : soapenc="http : / /schema s . xmlsoap . org/ soap /encoding/ " 

xmlns : generic IRPSystem= "http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/323 17 /schema/323 17- 

700/GenericIRP System" 

xmlns : kernelCMIRPSystem="http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/32 667 /schema/ 32 667- 

700/KernelCMIRP System" 

xmlns : kernelCMIRPData="http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/32 667 /schema/ 32 667- 

700/KernelCMIRPData" 

targetNamespace="http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/32 667 /schema/ 32 667- 

7 00/KernelCMIRPSystem"> 

< import name space =" http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/323 17 /schema/ 32 3 17- 
700 /GenericIRPSy stem" location="http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/323 17 /schema/323 17- 
7 0. zip" /> 
<types> 

< schema targetNamespace="http : //www. 3gpp . org/f tp/Specs/ar chive/32_series/32 667 /schema/ 32 667- 
700/KernelCMIRPData" xmlns="http: //www. w3 . org/200 l/XMLSchema"> 
<! — getNRMIRPVersion Request — > 
<element name="getNRMIRPVersion"> 
</element> 

<! — getNRMIRPVersion Response — > 
<element name="getNRMIRPVersionResponse"> 
<complexType> 
<sequence> 

<element name="versionNumberList " 
type="kernelCMIRPData: VersionNumberSetType" /> 

<element name="vSEVersionNumberList" 
type="kernelCMIRPData: VersionNumberSetType "/> 
</sequence> 
</complexType> 
</element> 

<! — getNRMIRPVersion Fault — > 
<element name="getNRMIRPVersionFault "> 
<complexType> 
<choice> 

<element name="getNRMIRPVersionFault " type=" string" /> 
</choice> 
</complexType> 
</element> 
<element name="OperationNot Support edFault " type=" string" /> 
<element name=" InvalidParameterFault " type=" string" /> 
< simple Type name="VersionNumberType"> 

< re strict ion base=" string" /> 
</ s imp le Type > 

<complexType name= "VersionNumber Set Type "> 
<sequence> 

<element name="versionNumber " type="kernelCMIRPData : VersionNumber Type" 
maxOccurs="unbounded" /> 
</sequence> 
</complexType> 

<complexType name= " P arameter Set Type "> 
<sequence> 

<element name="parameterName" type=" string" maxOccurs=" unbounded" /> 
</sequence> 
</complexType> 

<complexType name="OperationType"> 
<sequence> 

<element name="operationName" type=" string" /> 

<element name= "parameter Set " type="kernelCMIRPData : Parameter Set Type" /> 
</sequence> 
</complexType> 

<complexType name="OperationSetType"> 
<sequence> 

<element name=" operation" type="kernelCMIRPData : OperationType" 
maxOccurs="unbounded" /> 
</sequence> 
</complexType> 

< complex Type name="Notif icationType"> 
<sequence> 
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<element name="notif icationName" type=" string" /> 

<element name= "parameter Set " type="kernelCMIRPData : Parameter Set Type" /> 
</sequence> 
</complexType> 

<complexType name= "Not if icationSet Type" > 
<sequence> 

<element name="notif ication" type="kernelCMIRPData :Notif icationType" 
maxOccurs="unbounded" /> 
</sequence> 
</complexType> 

</schema> 
</types> 
<message name="getNRMIRPVersionRequest "> 

<part name="parameter " element="kernelCMIRPData : getNRMIRPVersion" /> 
</message> 
<message name="getNRMIRPVersionResponse"> 

<part name= "parameter" element="kernelCMIRPData : getNRMIRPVersionResponse" /> 
</message> 
<message name="getNRMIRPVersionFault "> 

<part name="parameter " element="kernelCMIRPData : getNRMIRPVersionFault "/> 
</message> 

<portType name="KernelCMIRP "> 

<operation name= " get IRP Vers ion "> 

< input message=" generic IRP System: getlRPVersionRequest "/> 

<output me ssage=" generic IRP System: getIRPVersionResponse"/> 

<f ault name="getIRPVersionFault " me ssage=" generic IRP System: get IRPVersionFault "/> 

</operation> 

<operation name="getOperationProf ile"> 

<input message="genericIRPSystem: getOperationProf ileRequest " /> 
< out put me ssage=" generic IRP System: getOperationProf ileResponse" /> 
<f ault name="getOperationProf ileFault " 
me ssage=" generic IRP System: getOperationProf ileFault "/> 

</operation> 

<operation name="getNotif icationProf ile"> 

< input me s sage= " gene ricIRP System: get Not if icationProf ileRequest "/> 
<output message=" generic IRPSy stem: get Not if icationProf ileResponse "/> 
< fault name="getNotif icationProf ileFault " 
me ssage=" generic IRP System: get Not if icationProf ileFault "/> 

</operation> 

<operation name= " get NRMIRP Vers ion "> 

<input message="kernelCMIRPSystem: getNRMIRPVersionRequest "/> 

<output me s sage= " kerne 1CMIRP System: getNRMIRPVersionResponse "/> 

< fault name=" getNRMIRPVersionFault" me ssage="kernelCMIRP System: getNRMIRPVersionFault "/> 

</operation> 

</portType> 

<binding name="KernelCMIRP " t ype= " ke r nelCMIRP System: Kerne 1CMIRP "> 

<soap: binding style= "document" transport="http: //schemas . xmlsoap. org/soap/http"/> 
<operation name="getIRPVersion"> 
<soap: operation 
soapAction="http: //www. 3gpp. org/ftp/Specs/archive/32_series/32 667 /schema/ 3 2 667-7 /get IRPVersion" /> 
< input > 

<soap:body use="literal"/> 
</input> 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name=" get IRPVersionFault "> 

<soap: fault name="getIRPVersionFault " use="literal"/> 
</fault> 
</operation> 

<operation name=" getOperationProf ile"> 
<soap: operation 
soapAction="http : //www. 3gpp . org/f tp/ Specs /arch ive/32_series/32 667 /schema/ 3 2 667- 
700/getOperationProfile"/> 
<input> 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name=" getOperationProf ileFault "> 

<soap: fault name="getOperationProf ileFault " use="literal"/> 
</fault> 
</operation> 
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<operation name="getNotif icationProf ile"> 
<soap: operation 
soapAction="http : //www. 3gpp . org/f tp/Specs/archive/32_series/32 667 /schema/ 32 667- 
700/getNot if icationProf ile" /> 
< input > 

<soap:body use="literal"/> 
</input> 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name= "get Not if icationProf ileFault "> 

<soap : fault name="getNotif icationProf ileFault " use=" literal "/> 
</fault> 
</operation> 

<operation name= " get NRMIRP Vers ion "> 
<soap: operation 
soapAction="http: //www. 3gpp. org/f tp/Specs/archive/32_series/32 667 /schema/ 32 667- 
700/getNRMIRPVersion"/> 
<input> 

<soap:body use="literal"/> 
</ input > 
<output> 

<soap:body use="literal"/> 
</output> 
< fault name="getNRMIRPVersionFault"> 

<soap: fault name="getNRMIRPVersionFault " use="literal"/> 
</fault> 
</operation> 
</binding> 
<service name="KernelCMIRP"> 

<port name="KernelCMIRP" binding= " ke r ne 1CMIRP System: Kerne 1CMIRP"> 

<soap: address location="To be defined. "/> 
</port> 
</service> 
</def initions> 
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Annex B (informative): 

Kernel CM IRP WSDL/XML schema electronic files 

The electronic files corresponding to the normative WSDL/XML schema defined in the present document are available 
in native form in the following archive: 

http://www.3gpp.org/ftp/Specs/archive/32_series/32667/schema/32667-700-wsdl.zip 
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Annex C (informative): 
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